home *** CD-ROM | disk | FTP | other *** search
/ Almathera Ten Pack 3: CDPD 3 / Almathera Ten on Ten - Disc 3: CDPD3.iso / scope / 201-220 / scopedisk215 / looker / lookerdoc < prev    next >
Text File  |  1995-03-19  |  13KB  |  425 lines
  1.                           LOOKER! Version 1.4
  2.                    by John Lullie - Copyright 1991
  3.  
  4.  
  5.  
  6. Comments, bug reports may be sent to:
  7.  
  8. CompuServe: UserID 70700,2454
  9. GEnie: UserID J.LULLIE
  10.  
  11.    Or Write To:
  12.  
  13.  
  14.        John Lullie
  15.        10701 SouthWest 10th Court
  16.        Davie, Florida 33324
  17.  
  18.  
  19.  
  20.  
  21.  
  22. Looker uses a very powerful Amiga-Dos command called "Search" to
  23. locate files matching the criteria you enter. Therefore, the file
  24. "Search" should be in your "C" directory for Looker to work. It is
  25. supplied by Commodore with WorkBench and it should already be in
  26. your "C" directory.
  27.  
  28.  
  29.  
  30. Looker will do a bit more than just find files for you.
  31. After successfully locating a file (or files) on any drive or assigned
  32. directory, there are a few options you can use AFTER the file(s)
  33. are found:
  34.  
  35.  
  36. * Open a Shell window directly into the path of your found file(s).
  37. * Print a listing of single or all found files with device and path
  38.   names where all the files are located. (Handy if you have a lot of
  39.   the same type files in different directories and want to reorganize
  40.   your Hard Drive. (i.e.".txt",".arc",".doc" files etc.))
  41.  
  42. * View a Report of Found files showing filenames only, number of files
  43.   found and the search string used. Also, if a path name is to long to
  44.   fit in the main window, you can click on a filename in the Report
  45.   window and the path will be selected back in the main window. From
  46.   there you can click the "Goto" button. (see "Goto" button below).
  47.  
  48. * Copy, Move or Delete a selected file.
  49.  
  50.  
  51.  
  52.  
  53. LOOKER IS SHAREWARE!!
  54.  
  55.  
  56.  
  57. It is freely distributable, provided all documentation and authors
  58. notices are left intact. Should you decide you like the program,
  59. please register by sending a check for $10 to me, the author, at
  60. the address listed above...
  61.  
  62.  
  63.  
  64. Your registration includes future updates and bug fixes, Laser Printed
  65. documentation, un-registered* versions of the following programs:
  66. (*SEE OPTIONAL OFFER BELOW!)
  67.  
  68. AliasIcon - Creates an alternate Icon for any program that can be
  69.             placed into any directory or kept right on the WorkBench
  70.             screen (WB2.0). Attach an Icon for any executable program,
  71.             a palette of 80 Icons to choose from, add your own script
  72.             commands, completely mouse driven and a 3D interface.
  73.  
  74. CDStore -   Compact Disk Database/Tracker. 3D interface, many features;
  75.             Sort, Search, Live Printer Preview Screen with three
  76.             different Print Formats and some other stuff I can't think
  77.             of right now.
  78.  
  79. VideoStore- Almost exactly the same as CDStore but dedicated to Video
  80.             cassettes/Movies. Same 3D Interface (different colors).
  81.  
  82.  
  83.  
  84. *OPTIONAL OFFER!
  85.  
  86. ================
  87.  
  88. If you send $15 instead of $10 for Looker!, I'll send you all three
  89. REGISTERED versions of AliasIcon, CDStore and VideoStore with Laser
  90. Printed Documentation for each. Believe me, you'll find this offer
  91. well worth the extra $5.
  92.  
  93. ===============================================================
  94.  
  95.  
  96.  
  97.   Un-Registered Version:
  98.  
  99.  
  100. You will notice that in this un-registered version, some options are
  101. disabled. All of the main functions are active and only the accessories
  102. (or Nifties) of the program are turned off.
  103.  
  104. ===============================================================
  105.  
  106.  
  107.  
  108. Requirements:
  109.  
  110.         Any Amiga w/512K or more
  111.  
  112.         WorkBench 2.0
  113.  
  114.  
  115.  
  116.  
  117. CHANGES AND ENHANCEMENTS TO Looker 1.4
  118.  
  119. * Added new menu options: Copy File, Move File and Delete File.
  120. * Added sub-items to print requester
  121. * A Preferences Dialog box has been added for changing some of the
  122.   characteristics of the program.
  123. * Zoom/Iconize window option added for getting Looker out of the way.
  124. * Snapshot menu options added to Report and Zoom window position.
  125. * Double-Clicking on a selected path/file now goes to the Shell.
  126. * More Dialog boxes/requesters.
  127. * File-Type added for identifying the kind of file found & selected.
  128. * A minor bug or two fixed.
  129.  
  130.  
  131.  
  132.  
  133.  
  134. Installing Looker:
  135.  
  136. - Copy Looker (and it's icon) to any directory you wish. It will
  137.   run from anywhere.
  138. - Copy "Deckrunner" to your "C" directory.
  139.  
  140.  
  141.  
  142. To launch Looker, double-click its icon.
  143.  
  144.  
  145.  
  146.   QUICK TUTORIAL:
  147.  
  148.  
  149.  
  150. Running Looker!:
  151.  When Looker is first started, you will see a small animated credit
  152.  window come up. Click anywhere in this window to make it go away.
  153.  Selecting the "About..." menu option will bring it back.
  154.  
  155.  
  156. Selecting Drive/Directory:
  157.  To the left of the window, click on the "Assigns" button. All of
  158.  your assigned devices and/or directories will be listed in the
  159.  center List window. Now Click on the "C" directory in this center
  160.  List window.
  161.  
  162.  
  163. Entering Search Strings:
  164.  Next, in the field at the top center of the screen (labeled "Search
  165.  String"), type in the text "ist" after the wild card characters "#?".
  166.  If you press [Return] after entering your text, the Search button
  167.  will be activated and the search will begin. The Status Box and drive
  168.  light will indicate that the search is in progress. Any files that
  169.  match the text you entered with the wildcard will be displayed in the
  170.  large Path window. In this case the command "List" in your "C"
  171.  directory would be displayed along with anything else that ends with
  172.  "ist" in that directory.
  173.  You could just as well select "DH0" or "SYS" and the entire selected
  174.  disk would be searched.
  175.  
  176.  
  177. "Goto"/"Goto & Quit" Buttons: After a search is complete, the large List
  178.  window at the bottom will display all found files and their paths.
  179.  
  180.  
  181. Click once on one of the path/files that were found in the large List
  182. window, then click the "Goto" button. A Shell window will open and you
  183. will be placed into the same directory that your selected file is in.
  184.  
  185.  
  186.  
  187. If you click on the "Goto & Quit" button, that's exactly what will
  188. happen - It opens the Shell and quits Looker. I thought adding this
  189. option would make it more convenient (if you found what you were
  190. looking for) to put you where you want to be and quit at the same time.
  191.  
  192.  
  193.  
  194.   NOTE: Double-clicking on a found path/file in the large List
  195.         window will also open the Shell into the selected path.
  196.  
  197.  
  198. MENU OPTIONS:
  199.  
  200.  
  201.  LOOKER MENU:
  202.  -----------
  203.    About Looker:
  204.  
  205.      Animated display of Credits. Click anywhere on this window to
  206.      close it.
  207.  
  208.    Prefs:
  209.  
  210.      Opens a dialog box and presents you with the following options:
  211.  
  212.      "Open With Animation" - If ON, the animated credit window will
  213.      open when Looker is first launched.
  214.  
  215.      "Insert Wildcard" - If ON, the AmigaDOS wildcard characters "#?"
  216.      will be inserted in the Search field.
  217.  
  218.      "Search Starts on [Return]" - If ON, pressing the [Return] after
  219.      entering your search text will start the search.
  220.  
  221.      "ZOOM Keeps Found Files" - If ON, clicking the Iconize/Zoom button
  222.      will keep what is currently in the Path/File List window before
  223.      becoming a tiny window. When you zoom back to Looker's main window,
  224.      all files and their paths will still be there.
  225.  
  226.  
  227.    Sort Listing:
  228.  
  229.      Sorts the path and files in the list window. If a lot of files were
  230.      found, this will help you locate the file(s) in the List or Report
  231.      windows more quickly.
  232.  
  233.  
  234.    Save Contents To:
  235.  
  236.      -Clipboard:
  237.        This option will save the contents of the path/file List window to
  238.        the Clipboard. This will allow you to paste this text into a word
  239.        processor, text editor or any other program that supports the
  240.        Amiga's Clipboard.
  241.  
  242.      -File:
  243.        Saves the contents of the path/file List window to an ASCII (text)
  244.        file. A file requester will open and prompt you for a filename.
  245.        Use the different buttons in this requester to navigate to where
  246.        you wish to save this file.
  247.  
  248.  
  249.  
  250.    Print:
  251.  
  252.      This acts as more of a utility than just printing a list of found
  253.      files. If for example you wanted to find all the files ending in
  254.      ".pic" or ".doc", this printed report would tell you what search
  255.      string was used, how many files were found and exactly where they
  256.      are located on your drive (i.e. May help you organize your Hard Drive).
  257.  
  258.       There are two Sub-Menu items for Print:
  259.  
  260.  
  261.  
  262.      -Entire List:
  263.        Prints all path and file names found after the search. The printout
  264.        will display which device was searched, the search text used etc..
  265.  
  266.      -Selected Only:
  267.        Prints only the highlighted path and filename along with device
  268.        searched, search text used etc....
  269.  
  270.  
  271.  
  272.  FILES MENU:
  273.  
  274.    Copy File:
  275.      Copies the selected file to another destination. You will be prompted
  276.      by a File Requester for the destination path. Use the buttons in this
  277.      requester to navigate to the drive/directory you want and click the
  278.      "OK" button.
  279.  
  280.    Move File:
  281.      Functions the same way as "Copy File" but will delete the original
  282.      file after the copy is made.
  283.  
  284.    Delete File:
  285.      Deletes the selected file from disk. You will be prompted with and
  286.      "Ok/Cancel" requester to confirm this action.
  287.  
  288.  
  289.  
  290. LOOKER WINDOW OBJECTS:
  291. =====================
  292.  
  293. Iconize/Zoom Button:
  294.  
  295.   Small button Located in the upper right corner under the Title bar.
  296.   Clicking this button will reduce Looker's window to a small Icon and
  297.   place it near the top center of your WorkBench screen and out of the
  298.   way. If you wish to have Looker position this Zoom somewhere else on
  299.   the screen, move it where you want it and select the "Snapshot Window"
  300.   menu option. The next time you use the Zoom option, it will be placed
  301.   in this new position. To return Looker to its normal state, click inside
  302.   the tiny window. You may also quit Looker from this window by making
  303.   it active and pressing LeftAmiga-Q.
  304.  
  305.  
  306. Search String Field:
  307.  This is where you enter the text to search for. The standard AmigaDos
  308.  wildcard Ò#?Ó is already in place and handled the same way as it is in
  309.  the CLI. After entering text, pressing the [Return] key will begin the
  310.  search without having to click the "Search" button.
  311.  
  312.  
  313. Device/Assign List Window:
  314.  The List window displays either drives or assigned devices depending on
  315.  the button selected (Assigns or Devices).
  316.  
  317.  
  318. Assignment/Device Buttons:
  319.  Assigns Button - Displays all current assignments in the list window;
  320.  C,S,SYS etc... Devices Button - Displays all drives in the List window.
  321.  (DF0,DF1,DH0,DH1 etc...)
  322.  
  323.  
  324. STATUS Bar:
  325.  Displays Looker activities such as searching, copying, moving and other
  326.  information about what the program is doing at any given time.
  327.  
  328.  
  329. Search Button:
  330.  Initiates the search on the drive or assigned device selected in the
  331.  List window. Same as pressing the [Return] key after entering your
  332.  search text.
  333.  
  334.  
  335. Goto:
  336.  Opens a new Shell into the path the found file(s) is in.  (Button is
  337.  only active if something was found)
  338.  
  339.  
  340. Goto & Quit: Same as "Goto" but will quit Looker after opening a Shell
  341. window and placing you into the selected files path. (Button is only
  342. active if something was found)
  343.  
  344.  
  345. Report Window: (Now has Menu option for User-defined window position.)
  346.  Opens a dialog box Showing Info about files found. Like the Main window,
  347.  this Report window may be dragged anywhere on the screen. If you want
  348.  Looker to remember where you placed this Report window - Simply make
  349.  sure the Report window is selected (clicking anywhere on it) and select
  350.  the "Snapshot Window" menu option.
  351.  Selecting "Default" will put the window in its original position (as if
  352.  you just installed Looker for the first time). NOTE: The Report window
  353.  must be closed to access Lookers main window again.
  354.  
  355.  
  356. Quit: Exits the program.
  357.  
  358.  
  359.  
  360. KEYBOARD EQUIVALENTS:
  361. ====================
  362.  
  363. LeftAmiga-A      Switches to the Assigned devices.
  364.  
  365. LeftAmiga-D      Switches to Drives; DF0, DF1, DH0 etc...
  366.  
  367. LeftAmiga-S      Starts Looking for files using the search string.
  368.  
  369. LeftAmiga-Q      Quits Looker. And if the tiny window is active.
  370.  
  371. RightAmiga-Q     Quits Looker. And if the tiny window is active.
  372.  
  373. Up/Down Arrows   Moves cursor Up and Down in the Path window.
  374.  
  375. Shifted
  376. Up/Down Arrows   Moves cursor Up and Down the Assign/Device window.
  377.  
  378.  
  379.  
  380.  
  381.  
  382.  
  383.  
  384.  
  385.  
  386.  
  387.  
  388.  
  389.  
  390. General Notes:
  391.  
  392.  
  393.  
  394. You will notice some of the menu options are followed by an
  395. ellipsis ("..."). This simply means that some kind of requester
  396. or dialog box will appear before
  397.  
  398. the option is selected. You will find that many applications use
  399. this symbol for this purpose. In CDStore2.0 for example, the main
  400. window has a "Print..." button that uses this symbol. Clicking this
  401. button will not print immediately but will take you to another
  402. screen entirely (Print/Page Setup).
  403.  
  404.  
  405. The Preferences dialog box, when closed, will re-initialize Looker
  406. with the new settings. All settings will take effect after the "Ok"
  407. button is pressed with the exception of the Animated window (This
  408. setting will be used the next time Looker is launched.).
  409.  
  410.  
  411. Snapshot Window options will take effect the next time that
  412. particular window is opened. You will notice a slight hesitation
  413. before your window is moved to your new assigned position. These
  414. windows will open in their original default position and THEN
  415. immediately move to your assigned position. Hopefully this will not
  416. become an annoyance.
  417.  
  418.  
  419.  
  420.  
  421.  
  422.   Hope you find Looker Useful!!
  423.  
  424.       Thanks
  425.               J.LULLIE